home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d10
/
infoselt.arc
/
SWAPIS.DOC
< prev
next >
Wrap
Text File
|
1990-11-11
|
14KB
|
325 lines
The SWAP Utilities(TM)
Version 1.55
SWAPIS(TM) -- For Info Select
The SWAP Utilities(TM) and this Documentation are:
Copyright 1989, Innovative Data Concepts
All Rights Reserved.
This document; other accompanying written and disk-based notes and
specifications; and all referenced and related program files accompanying
this document are copyrighted by Innovative Data Concepts.
TRADEMARKS
SWAPIS and The SWAP Utilities are trademarks of Innovative Data Concepts.
Info Select is a trademark of Micro Logic Corp.
WHAT THE SWAP UTILITIES DO
The SWAP Utilities intercept certain DOS calls made by ram-resident
applications, and "swap" the entire resident portion of the application
to extended or expanded memory, or to disk files.
This will greatly decrease the amount of "real" RAM needed to load
Info Select.
If swapping goes to disk, two swapfiles are created in the drive and
directory specified with command line option /D or the TEMP environment
variable. A third swapfile is created on disk no matter what swapping
method you have selected.
INSTALLATION
Just copy SWAPIS.COM into the same directory that IS.EXE is located in.
No further installation is necessary.
-DESQview
In order to successfully use SWAPIS with DESQview, you must run
TESTDV.COM first.
Copy TESTDV.COM and T2-PIF.DVP into your DESQview directory. If you
already have a T2-PIF.DVP, re-name the one provided with SWAPIS to a
different filename. Select Add a Program, and add the "SWAP Utilities
Configuration" to your program list. Then, open the window, jot down
the options specified by TESTDV, and add them to your SWAPIS command
line(s).
Once you run this program, it is only needed again if you change the TSRs
that you load globally with DV.
IMPORTANT NOTE!! Unless you have QEMM 5.x and a DESQview version later
than 2.26 on 386 machines, you will be unable to pop up SWAPIS if you have
a DV window open with "Virtualize Text and Graphics" set to "y". This
is because DV uses the 386 "virtual 86" mode to virtualize the video
screen, and does not provide any way (short of adding a 386 memory
manager to SWAP??) to gain control.
LOADING AND USING SWAPIS
There are two ways to load SWAPIS -- from the command-line, or from a
batch file. By default, SWAPIS assumes you will be starting it from the
DOS command-line, and automatically adds the appropriate keystroke sequences
to the keyboard buffer to load your application.
-Loading from the Command Line
When loading from the DOS command line, use the following syntax:
SWAPIS <command line options>
When loaded from the command line, the SWAP utility will load your
application for you.
-Loading from a Batch File
If you load SWAPIS from a batch file, you must use the /N command line option
(described below), followed by an immediate load of your application. For
example:
File STARTIS.BAT:
CD \IS
SWAPIS /N
IS 99
CD \
When using the /N switch, you must load the application yourself. SWAPIS
will not respond to the hotkey until the application has been loaded.
Once SWAPIS and Info Select have been loaded into memory, SWAPIS will
display a message stating it has successfully loaded the application,
and give an actual report of memory available. This memory value
is in Kilobytes, so multiply by 1024 to get actual bytes free.
The display will also tell you what kind of memory was used for the swapping;
extended memory, expanded memory, or disk virtual memory. If for any reason
SWAPIS unable to correctly swap out the application, a message will be
displayed notifying you of that occurrence, and both SWAPIS and Info Select
will be removed from memory.
-Command Line Options
/H /? ? -- Display a help screen
/N -- When used in a batch file
/U -- Remove SWAP?? and application from RAM
/Dpath -- FULL PATHNAME to store swap files on (if not enough
EMS is present)
/Sx -- Set Swapping type (0=Auto, 1=Disk, 2=EMM, 3=XMS)
SwapType = 0 is the default; if selected type fails (i.e.,no XMS
is available with /S3), auto-check is done.
/Tx -- Pasting Throttle (0=slow, 1=medium, 2=fast, 3=compat) [default=2]
/V -- Special DESQview Options
To set the hotkey
/A -- Use Alt-Key for hotkey shift state
/C -- Use Ctl-Key for hotkey shift state
/L -- Use Left-Shift-Key for hotkey shift state
/R -- Use Right-Shift-Key for hotkey shift state
/Kxx -- Scan code for hotkey to use (see chart in documentation)
requires two HEX digits following the /K
SWAPIS automatically defaults to the Alt-J hotkey. Do not use any
command-line options for Info Select to change the hotkey -- use the SWAPIS
options instead.
-Explanation of Command Line Options
/N -- If the /N switch is used, The SWAP utility will not automatically place
the appropriate keystroke combination to load the application into the
keyboard buffer when it goes resident. This option must be used when loading
The SWAP Utilities from a batch file.
/U -- Use this option to cleanly remove SWAP?? and your application from RAM.
If disk swapping is in use, the swap files will be deleted before freeing
memory. If the application also uses expanded memory, it will be freed as
well. If the application uses disk-based swap files (such as those SideKick
Plus uses) they will not be deleted.
Do not attempt to use the Info Select "unload" feature. Use the /U feature
of the SWAP utility instead.
/Sx -- The /S parameter determines the type of swapping to use. In the
default Autodetect mode, The SWAP Utility will attempt to allocated expanded
memory, using EMS version level 3.2 or later. If EMS is not available, the
utility will attempt to use Extended Memory that is available, using
Microsoft's eXtended Memory Specification (XMS) (See note about XMS below).
If neither EMS or XMS is available, two swap files will be created, and
SWAP?? will use disk (default, C:\) for swapping. The /S parameter can
be used to override the default mode, and force swapping to XMS, EMS
or Disk. If the swapping method specified with /S is not valid, then Auto
mode is used. Note that the third swapfile (SWAP??.SW3) is created in the
path specified by the /D parameter, or the TEMP environment variable, no
matter what swapping method is chosen.
/Dpath -- The /D parameter tells the SWAP utility in what drive and directory
to store the swap files. The default is the root directory on drive C
(C:\). The pathname is limited to 30 characters, and must contain a valid
drive specification, and path. The trailing backslash is not necessary.
If the /D parameter is not the last option on the command-line, there must
be a space character following the pathname and before another slash option.
Note that at least one disk-based swap file will always be created on this
path. An example path is: /DC:\TEMP
/Tx -- This option may be used to "throttle" down the pasting speed of the
SWAP utility you are using. Some applications, such as the Norton Editor,
cannot handle characters as fast as SWAP?? can feed them, requiring a slower
speed to be used. The valid values here are 0, 1, 2 or, ranging from
slowest (0) to fastest (2). The /T3 switch is for "compatibility" mode. Use
this switch if you are using a program that relocates the BIOS keyboard
buffer, or expands the keyboard type-ahead buffer. This is the slowest
option, but pasting will work in all cases. The default is fast (/T2).
Selecting Hot Keys
The SWAP Utilities allow the use of more hotkeys than most applications do;
for example, they will accept F11 (/K57), or Ctl-LShift-Q (/C /L /K10). The
following table can be used to determine the scan codes of the key you wish
to use with the /K parameter; this is not a complete table, it is intended
simply as a guide:
KEY CODE KEY CODE
---------------------------------
A 1E B 30
C 2E D 20
E 12 F 21
G 22 H 23
I 17 J 24
K 25 L 26
M 32 N 31
O 18 P 19
Q 10 R 13
S 1F T 14
U 16 V 2F
W 11 X 2D
Y 15 Z 2C
0 0b 1 02
2 03 3 04
4 05 5 06
6 07 7 08
8 09 9 0A
- 0C = 0D
F1 3B F2 3C
F3 3D F4 3E
F5 3F F6 40
F7 41 F8 42
F9 43 F10 44
F11 57 F12 58
-Sample Command Lines
SWAPIS /K58 /T1 /S1 /DE:\
This command would load SWAPIS, swapping to the root directory of drive E:,
using a hotkey of F12, and a paste speed of medium.
SWAPIS /l/a/k25/df:\swappath
This would load SWAPIS, swapping to EMS if available, otherwise to
F:\SWAPPATH, with a hotkey of Left-Shift-Alt-K.
SWAPIS /dD:\ /A/k14/S1
This would load SWAPIS, swapping to D:\, with a hotkey of Alt-T.
-Extended Memory
In order to use extended memory with SWAPIS, you must use a driver that
supports Microcoft's "eXtended Memory Specification (XMS), ver 2.0", such
as Microsoft's HIMEM.SYS. The current versions of 386MAX and QEMM (versions
later than 5.0) both support XMS on 386 machines; alternatively, the
latest official XMS driver may be gotten free from Microsoft, either through
their Compuserve Forum (GO MSSYS), or by calling Microsoft customer service
at (800)426-9400 and ask for a copy of the "XMS Specification and it's supplemental diskette."
Please note that if your computer supports both XMS and EMS, EMS memory is
the preferred choice; using XMS requires almost twice the amount of memory.
IMPORTANT NOTES
-General Notes
If you are swapping to disk, two swapfiles are created in the specified drive
and directory. A third swapfile is created no matter what swapping method
you have selected.
These swapfiles must not be deleted while the SWAP utility is loaded. Doing
so will cause your machine to crash if you attempt to popup!
You must load The SWAP Utilities after all network drivers, disk cache
programs, and other programs that require background processing. With these
exceptions, load order is not important. You can load The SWAP Utilities at
any point, early or late in your TSR order. You can also load The SWAP
Utilities in extra, or 'high' DOS memory with 386Max(TM) or QEMM-386(TM).
You may safely load a SWAP utility inside a Software Carousel(TM) partition,
or as a global SC utility. You may notice a period of a blank screen when
attempting to swap partitions after having used a SWAP utility, but be
patient, and the partition will change normally.
When pasting large blocks into an application, you will occasionally see a
"hiccup" with the SWAP message on the display -- this is caused by swapping
your aplication in and out, to read the next set of keys. Most applications
support virtually unlimited paste buffers, and the memory used by the SWAP
utilities is limited.
In general, do not attempt to use a particular application's "unload" or
"remove from memory" feature. It won't work, and will in all likelihood
crash your machine. Use the /U feature of the SWAP utility instead.
When creating swap files for disk-based swapping, the SWAP utilities default
to the root directory of Drive C:. If you create an environment string
called TEMP with the SET command, the utilities will instead default to the
directory specified by that command, and the use of /D will not be necessary.
An example of setting an environment string would be:
SET TEMP=G:\
where G is a fast RAM disk. This would cause disk-swapping to take place
in the root directory of Drive G:. The environment variable TEMP must, of
course, be set prior to loading your SWAP utility. The programs will
attempt to swap in the following sequence: 1) Try to swap to EMS; 2) If /D
specified, try to swap to specified path; 3) Try to find environment variable
named "TEMP" and if it exists, swap to the specified path; 4) Try to swap to
the root directory of Drive C:; or, 5) abort, and remove both the application
and the SWAP utility from memory.
-Note for Microsoft Word Users:
When using The SWAP Utilities with Microsoft Word, you should not use the /G
switch, even if you plan to use Word in graphics modes. The SWAP Utilities
automatically detect the presence of MS Word 4.0 and 5.0, and will switch
between text and graphics modes as needed. This switch works on CGA, EGA
VGA and Hercules systems with Word 4.0, except in Hercules 90x43 mode.
Word 5.0 users who work in graphics mode will need to do an extra bit of
setup. In order for the switch between text and graphics to work, you
must set both text and graphic display modes in the Word 5.0 Options menu.
Load Word 5.0, and bring up the Options menu. Select the appropriate
text display mode for your system. Return immediately to the Options
menu, and now select the graphics display mode you wish to work in.
Test the results by pressing Alt-F9, to toggle between text and
graphics modes. Exit from Word, and you're all set!
-Specific Notes
You will not be able to load Info Select using the "repeat" option.
If you do not use the /N switch, SWAPIS will load Info Select as "IS".